<html>

<head>
<meta http-equiv=Content-Type content="text/html; charset=utf-8">
<meta name="Author" content="Michael Margraf">
<meta name="Translator" content="Helio de Sousa">
<title>Qucs - Formato dos Arquivos de Diagrama Elétrico</title>
</head>



<body>
<a name="top" id="top"></a>

<center><h3>
- Qucs -<br>
Simulador de Circuitos Completamente Universal<br>
</h3>
<h1>
Formato dos Arquivos de Diagrama Elétrico<br><br>
</h1></center>

Este documento descreve o formato dos arquivos de diagrama elétrico do Qucs.
Este formato é utilizado para diagramas elétricos (normalmente com o sufixo ".sch")
e para exibir dados (normalmente com o sufixo ".dpl").
O texto abaixo mostra um exemplo curto de um arquivo de diagrama elétrico.
<br><br>

<tt><small>
&#060;Qucs Schematic 0.0.6&#062; <br>
&#060;Properties&#062; <br>
  &nbsp;&nbsp;&#060;View=0,0,800,800,1,0,0&#062; <br>
&#060;/Properties&#062; <br>
&#060;Symbol&#062; <br>
  &nbsp;&nbsp;&#060;.ID -20 14 SUB&#062; <br>
&#060;/Symbol&#062; <br>
&#060;Components&#062; <br>
  &nbsp;&nbsp;&#060;R R1 1 180 150 15 -26 0 1 "50 Ohm" 1 "26.85" 0 "european" 0&#062; <br>
  &nbsp;&nbsp;&#060;GND * 1 180 180 0 0 0 0&#062; <br>
&#060;/Components&#062; <br>
&#060;Wires&#062; <br>
  &nbsp;&nbsp;&#060;180 100 180 120 "" 0 0 0 ""&#062; <br>
  &nbsp;&nbsp;&#060;120 100 180 100 "Input" 170 70 21 ""&#062; <br>
&#060;/Wires&#062; <br>
&#060;Diagrams&#062; <br>
  &nbsp;&nbsp;&#060;Polar 300 250 200 200 1 #c0c0c0 1 00 1 0 1 1 1 0 5 15 1 0 1 1 315 0 225 "" "" ""&#062; <br>
    &nbsp;&nbsp;&nbsp;&nbsp;&#060;"acnoise2:S[2,1]" #0000ff 0 3 0 0 0&#062; <br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#060;Mkr 6e+09 118 -195 3 0 0&#062; <br>
  &nbsp;&nbsp;&#060;/Polar&#062; <br>
&#060;/Diagrams&#062; <br>
&#060;Paintings&#062; <br>
  &nbsp;&nbsp;&#060;Arrow 210 320 50 -100 20 8 #000000 0 1&#062; <br>
&#060;/Paintings&#062; <br>
</small></tt>
<br><br>

O arquivo contém várias seções. Cada uma delas é explicada abaixo.
Cada linha consiste em nada mais que um bloco de informação que
começa com um sinal de menor "&#060;" e termina com um sinal de maior
"&#062;".

<br>
<h3>Properties</h3>
A primeira seção começa com "&#060;Properties&#062;" e termina com
"&#060;/Properties&#062;". Ela contém as propriedades de documento do
arquivo. Cada uma das linhas é opcional. As seguintes propriedades são suportadas:
<br>
<ul>
<li><em>&#060;View=x1,y1,x2,y2,scale,xpos,ypos&#062;</em> contém
a posição dos pixels da janela do esquema elétrico nos primeiros quatro números,
sua escala atual e a posição atual do canto superior esquerdo
(dois últimos números).</li>
<li><em>&#060;Grid=x,y,on&#062;</em> contém a distância da grade em
pixels (primeiros dois números) e se a grade está ligada (último número
1) ou desligada (último número 0).</li>
<li><em>&#060;DataSet=name.dat&#062;</em> contém o nome do arquivo de
dados associado com este esquema elétrico.</li>
<li><em>&#060;DataDisplay=name.dpl&#062;</em> contém o nome do arquivo de
exibição de dados associado com o esquema elétrico (ou nome do arquivo
de esquema elétrico se este documento for um arquivos de exibição de dados).</li>
<li><em>&#060;OpenDisplay=yes&#062;</em> contém 1 se a página de exibição de
dados abrir automaticamente após a simulação, caso contrário contém 0.</li>
</ul>

<br>
<h3>Symbol</h3>
Esta seção começa com "&#060;Symbol&#062;" e termina com
"&#060;/Symbol&#062;". Ela contém os elementos desenhados criando um
esquema elétrico simbólico para o arquivo. Isto só é normalmente usado para
arquivos de esquemas elétricos que signifiquem estar em subcircuitos.

<br>
<h3>Components</h3>
Esta seção começa com "&#060;Components&#062;" e termina com
"&#060;/Components&#062;". Ela contém os componentes do circuito do
esquema elétrico. O formato da linha é como se segue:
<br>
<em>&#060;type name active x y xtext ytext mirrorX rotate "Value1" visible "Value2" visible ...&#062;</em>
<br>
<ul>
<li>type identifica o componente, ex. "R" para um resistor, "C" para
um capacitor.</li>
<li>name é o identificador único para o componente do esquema elétrico, ex. "R1"
para o primeiro resistor.</li>
<li>Um "1" no campo active mostra que o componente está ativo, isto é,
ele será usado na simulação. Um "0" mostra que está desativado.</li>
<li>Os próximos dois números são as coordenadas x e y do centro do
componente.</li>
<li>Os próximos dois números são as coordenadas x e y do canto superior esquerdo
da componete de texto. Elas são relativas ao centro do componente.</li>
<li>Os próximos dois números indicam o espelhamento sobre o eixo x ("1" para
espelhado, "0" não espelhado) e a rotação no sentido anti-horário
(multiplos de 90 graus, ex. 0...3).</li>
<li>As próximas entradas são os valores das propriedades do componente (entre
aspas duplas) seguidos por um 1 se a propriedade estiver visível no esquema
elétrico (caso contrário 0).</li>
</ul>

<br>
<h3>Wires</h3>
Esta seção começa com "&#060;Wires&#062;" e termina com
"&#060;/Wires&#062;". Ela contém os fios (conexão elétrica
entre os componentes do circuito) e seus rótulos e nós. O
formato da linha é como se segue:
<br>
<em>&#060;x1 y1 x2 y2 "label" xlabel ylabel dlabel "node set"&#062;</em>
<br>
<ul>
<li>Os primeiros quatro números são as coordenadas do fio em pixels:
coordenada x do ponto inícial, coordenada y do ponto inicial,
coordenada x do ponto final e coordenada y do ponto final. Todos os fios
devem ser horizontais (ambas coordenadas x iguais) ou verticais
(ambas coordenadas y iguais).</li>
<li>A primeira propriedade entre aspas duplas é o rótulo. Ela fica
vazia se nenhum rótulo for atribuído a este fio.</li>
<li>Os próximos dois números são as coordenadas x e y do rótulo
ou zero se o rótulo não existir.</li>
<li>O próximo número é a distância entre o ponto de início do fio
e o ponto onde o rótulo for atribuído no fio.</li>
<li>A última propriedade entre aspas duplas é o nó do fio,
ex. a tensão inicial neste nó usada pela simulador para
encontrar a solução. Este fica vazio se o usuário não definir
um nó para este fio.</li>
</ul>

<br>
<h3>Diagrams</h3>
Esta seção começa com "&#060;Diagrams&#062;" e termina com
"&#060;/Diagrams&#062;". Ela contém os diagramas com seus gráficos e
seus marcadores.
<br>
<em>&#060;x y width height grid gridcolor gridstyle log xAutoscale xmin xstep xmax
          yAutoscale ymin ystep ymax zAutoscale zmin zstep zmax xrotate yrotate zrotate
	  "xlabel" "ylabel" "zlabel"&#062;</em>
<br>
<ul>
<li>Os primeiros dois números são as coordenadas x e y do canto esquerdo inferior.</li>
<li>Os dois números seguintes são a largura e altura de limitação do diagrama.</li>
<li>O quinto número é 1 se a grade estiver ligada e 0 se estiver desligada.</li>
<li>O próximo é a cor da grade em valor RGB hexadecimal de 24 bits, ex.
#FF0000 é vermelho.</li>
<li>O próximo número determina o estilo da grade.</li>
<li>O próximo número determina quais eixos tem escala locarítmica.</li>
<li></li>
</ul>

<br>
<h3>Paintings</h3>
Esta seção começa com "&#060;Paintings&#062;" e termina com
"&#060;/Paintings&#062;". Ela contém as pinturas que estão
dentro do esquema elétrico.

<br><br><a href="#top">voltar ao topo</a><br>
</body>
</html>
